Donation Creator

Name - Enter a name for the content item. This text appears during design mode (configuration).
Title - Enter the text to display above this iPart on the rendered page. If blank, no title displays.
Do not render in design mode - Select this option to prevent content record data from being loaded in the content editor. This improves performance during design time (configuration).
iPart CSS class - (optional) Enter the name of a CSS class that will be applied to the iPart at runtime. Add this CSS class to an appropriate style sheet. Using such classes lets you apply special formatting to targeted iParts in a reusable way.
Display a border around this content - Select this option to display a border around this iPart on the rendered page.
Display content within a collapsible panel - Enable to allow users to minimize the panel within the page, to work with dense pages more efficiently.
- Show the content as collapsed - Enable to display the panel minimized by default.
  Tip: Be sure that the Title makes clear what data is hidden from view.
Display the gift distribution description - If you want to display a detailed description of the donation's distribution on the rendered page, enable this checkbox. You can find your distribution codes and edit the descriptions in iMIS Desktop from Fundraising > Set up tables > Distributions and premiums.
Display the Gift Item description - If you want to display a detailed description of the donation's description on the rendered page, enable this checkbox. You can edit the Gift Item descriptions from the Shop. Select the Gift Item, then click (Edit).
Processing mode - Donations made through this iPart can be processed in one of two ways. Choose the option that best fits your use of this iPart.
- Add donation to the cart - When selected, donations made through this iPart are added as an item in the user's shopping cart. They can then check out and pay for the donation as well as any other items in their cart.
- Process donation immediately - When selected, donations can be processed and paid for without using the shopping cart. If this option is selected, then other iParts need to be added to the content record, with the proper Commit sequence (see below for details).
Distribution - Donations made through your website must be associated with a valid distribution code defined in iMIS. This code can be specified in two ways.
- Set the distribution by an ItemId URL parameter - Indicates that the content record containing the Donation Creator will be dynamically populated based on the value of an ItemId parameter in the URL. If selected, you must pass a valid distribution code to your Donation Creator iPart using a relative link, absolute link, or navigation item. The URL parameter is ItemId=[Distribution code]. For example, if you want to create an absolute link to a donation page for the BLDG distribution, set the URL to http://mywebsite.com/donationpage.aspx?ItemId=BLDG. Or, if you want to assign that same parameter from the navigation item instead, enter ItemId=BLDG into the URL Parameters field.
- Select a distribution code - Specifies a single distribution code to be used for any donations made from the iPart. If selected, this option overrides the value of ItemId parameters in the URL.
Gift Item - Donations made through your website must be associated with the Item Code of a Gift Item (create Gift Item's from Shop > (Add)). You can associate donations with the required Item Code in two ways.
- Set the Gift Item by an ItemId URL parameter - Indicates that the content record containing the Donation Creator will be dynamically populated based on the value of an ItemId parameter in the URL. If selected, you must pass a valid Item Code to your Donation Creator iPart using a relative link, absolute link, or navigation item. The URL parameter is ItemId=[Item Code]. For example, if you want to create an absolute link to a donation page for the BLDG Gift Item, set the URL to http://mywebsite.com/donationpage.aspx?ItemId=BLDG. Or, if you want to assign that same parameter from the navigation item instead, enter ItemId=BLDG into the URL Parameters field.
- Select a Gift Item - Specifies a single Gift Item to be used for any donations made from the iPart. If selected, this option overrides the value of ItemId parameters in the URL.
Commit sequence - Allows you to explicitly define the execution order of multiple iParts in a content record. The number in this field indicates the processing order for this iPart, relative to the other iParts in the same content record. The value must be 0 or greater. You can leave the default value of 0 if the execution order of iParts is not a concern. iParts with a value of 0 are processed after any other iParts with a non-zero Commit sequence value that are on the same content record.
For example, processing a donation immediately requires that multiple iParts are defined in a single content record. It does not matter the order in which the iParts are defined on the page. In the scenario outlined below, where the Donation Creator is the first iPart displayed on the page and the Submit Order Button Link is the last iPart displayed, the Commit sequence value controls the order in which the iParts are processed. When the donation is "submitted" from the content record, execution control is given to each iPart based on the Commit sequence value shown in parentheses:
- Donation Creator (2)
- Contact Account Creator (1)
- Payment Creator (3)
- Submit Order Button Link (4 or 0)
Item added message (Cart mode) - Enter the message to display when a donation is successfully added to a user's cart. This text is only displayed if the iPart's Processing mode is Add donation to the cart.
Personalized gift array query - Specifies a query that generates an array of gift amounts based on the signed-in user's prior giving history. For example, if a user's last donation was $50, the gift array shown would be 55, 110, 220, 440, and a free text entry field. A sample query has been provided in $/Fundraising/DefaultSystem/Queries/ProductFundraising/GiftArray. If no query is selected, or if an unauthenticated user navigates to the page, the default gift array for the distribution displays (defined in the GIFT_AMOUNT lookup table).
Personalized gift array query - This option is planned for a future release.

Notes

By default, the Donation Creator displays a single, empty Gift Amount field. However, you also have the option to display an array of gift amounts from which the user can select, or to display a single Gift Amount field that is pre-populated with a gift amount of your choice. To do either of these, first create a GIFT_AMOUNT table from iMIS Desktop > Customers > Set up tables > General lookup/validation. In the Code field, enter the distribution code for which you want to customize the display. For example, BLDG. The values you enter in the Description field determine what is displayed on the donation webpage:
- To display an array of gift amounts, enter a comma-separated list of gift values that you want to appear in the list. For example, entering 50,100,200,500 results in a radio list of those values displayed on the page. To preselect an option, precede the number with an asterisk: 15,*25,75. The gift array always displays an option for the user to select Other and enter any amount.
- To display a single Gift Amount field with a pre-populated gift amount, enter a single amount. For example, 25.

Related Helpsite topics

Using the Donation Creator
Fundraising